home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cat3 / complib / cpttrs.z / cpttrs
Encoding:
Text File  |  1998-10-30  |  2.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. CCCCPPPPTTTTTTTTRRRRSSSS((((3333FFFF))))                                                          CCCCPPPPTTTTTTTTRRRRSSSS((((3333FFFF))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      CPTTRS - solve a system of linear equations A * X = B with a Hermitian
  10.      positive definite tridiagonal matrix A using the factorization A =
  11.      U**H*D*U or A = L*D*L**H computed by CPTTRF
  12.  
  13. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.      SUBROUTINE CPTTRS( UPLO, N, NRHS, D, E, B, LDB, INFO )
  15.  
  16.          CHARACTER      UPLO
  17.  
  18.          INTEGER        INFO, LDB, N, NRHS
  19.  
  20.          REAL           D( * )
  21.  
  22.          COMPLEX        B( LDB, * ), E( * )
  23.  
  24. PPPPUUUURRRRPPPPOOOOSSSSEEEE
  25.      CPTTRS solves a system of linear equations A * X = B with a Hermitian
  26.      positive definite tridiagonal matrix A using the factorization A =
  27.      U**H*D*U or A = L*D*L**H computed by CPTTRF.
  28.  
  29.  
  30. AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  31.      UPLO    (input) CHARACTER*1
  32.              Specifies whether the superdiagonal or the subdiagonal of the
  33.              tridiagonal matrix A is stored and the form of the factorization:
  34.              = 'U':  E is the superdiagonal of U, and A = U'*D*U;
  35.              = 'L':  E is the subdiagonal of L, and A = L*D*L'.  (The two
  36.              forms are equivalent if A is real.)
  37.  
  38.      N       (input) INTEGER
  39.              The order of the tridiagonal matrix A.  N >= 0.
  40.  
  41.      NRHS    (input) INTEGER
  42.              The number of right hand sides, i.e., the number of columns of
  43.              the matrix B.  NRHS >= 0.
  44.  
  45.      D       (input) REAL array, dimension (N)
  46.              The n diagonal elements of the diagonal matrix D from the
  47.              factorization computed by CPTTRF.
  48.  
  49.      E       (input) COMPLEX array, dimension (N-1)
  50.              The (n-1) off-diagonal elements of the unit bidiagonal factor U
  51.              or L from the factorization computed by CPTTRF (see UPLO).
  52.  
  53.      B       (input/output) REAL array, dimension (LDB,NRHS)
  54.              On entry, the right hand side matrix B.  On exit, the solution
  55.              matrix X.
  56.  
  57.      LDB     (input) INTEGER
  58.              The leading dimension of the array B.  LDB >= max(1,N).
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CCCCPPPPTTTTTTTTRRRRSSSS((((3333FFFF))))                                                          CCCCPPPPTTTTTTTTRRRRSSSS((((3333FFFF))))
  71.  
  72.  
  73.  
  74.      INFO    (output) INTEGER
  75.              = 0:  successful exit
  76.              < 0:  if INFO = -i, the i-th argument had an illegal value
  77.  
  78.  
  79.  
  80.  
  81.  
  82.  
  83.  
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.